home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / fractal / frasr182 / help4.src < prev    next >
Text File  |  1993-08-18  |  81KB  |  1,737 lines
  1. ~Topic=Startup Parameters\, Parameter Files
  2. ; This topic is online only.
  3.  
  4. ~Format-
  5.     { Summary of all Parameters }
  6.     { Introduction to Parameters }
  7.     { Using the DOS Command Line }
  8.     { Setting Defaults (SSTOOLS.INI File) }
  9.     { Parameter Files and the <@> Command }
  10.     { General Parameter Syntax }
  11.     { Startup Parameters }
  12.     { Calculation Mode Parameters }
  13.     { Fractal Type Parameters }
  14.     { Image Calculation Parameters }
  15.     { Color Parameters }
  16.     { Doodad Parameters }
  17.     { File Parameters }
  18.     { Sound Parameters }
  19.     { Video Parameters }
  20.     { Printer Parameters }
  21.     { 3D Parameters }
  22. ;
  23. ;
  24. ~Topic=Summary of all Parameters, Label=HELPCOMMANDS
  25. ; This topic is online only.
  26. ~Format-
  27.  
  28. {Startup Parameters}
  29.   @filename[/setname]       Process commands from a file
  30.   [filename=]filename       Start with this saved file (one saved by FRACTINT
  31.                or a generic GIF file [treated as a plasma cloud])
  32.                ('filename=' is required except on command line)
  33.   batch=yes           Batch mode run (display image, save-to-disk, exit)
  34.   autokey=play|record       Playback or record keystrokes
  35.   autokeyname=filename       File for autokey mode, default AUTO.KEY
  36.   fpu=387|iit|noiit       Assume 387 or IIT fpu is present or absent
  37.   makedoc=filename       Create Fractint documentation file
  38.  
  39. {Calculation Mode Parameters}
  40.   passes=1|2|g|b|t       Select Single-Pass, Dual-Pass, Solid-Guessing,
  41.                Boundary-Tracing, or the Tesseral drawing
  42.                algorithms
  43.   fillcolor=normal|<nnn>   Sets a block fill color for use with Boundary
  44.                      Tracing and Tesseral options          
  45.   float=yes           For most functions changes from integer math to fp
  46.   symmetry=xxxx        Force symmetry to None, Xaxis, Yaxis, XYaxis,
  47.                Origin, or Pi symmetry.  Useful for debugging.
  48. ~FF
  49.  
  50. {Fractal Type Parameters}
  51.   type=fractaltype       Perform this Fractal Type (Default = mandel)
  52.                See {Fractal Types} for a full list
  53.   params=xxx[/xxx[/...       Begin with these extra Parameter values
  54.                (Examples:  params=4   params=-0.480/0.626)
  55.   function=fn1/.../fn4       Allows specification of transcendental functions
  56.                with types using variable functions. Values are
  57.                sin, cos, tan, cotan, sinh, cosh, tanh, cotanh,
  58.                exp, log, sqr, recip (1/z), ident (identity),
  59.                conj, flip, zero, and cosxx (cos with bug)
  60.   formulaname=name       Formula name for 'type=formula' fractals
  61.   lname=name           Lsystem name for 'type=lsystem' fractals
  62.   ifs=name           IFS name for 'type=ifs' fractals
  63.   3dmode=monocular|left|right|red-blue  Sets the 3D mode used with Julibrot
  64.   julibrot3d=nn[/nn[/nn[/nn[/nn[/nn]]]]]")  Sets Julibrot 3D parameters zdots, 
  65.                            origin, depth, height, width, and distance
  66.   julibroteyes=nn          Distance between the virtual eyes for Julibrot
  67.   julibrotfromto=nn/nn[/nn/nn] "From-to" parameters used for Julibrot 
  68.   miim=[depth|breadth|walk]/[left|right]/[xxx/yyy[/zzz]] Params for MIIM
  69.                            julias.  xxx/yyy = julia constant, zzz = max hits.
  70.                            Eg. miim=depth/left/-.74543/.11301/3
  71. ~FF
  72. {Image Calculation Parameters}
  73.   corners=xmin/xmax/ymin/ymax[/x3rd/y3rd]
  74.                Begin with these Coordinates
  75.                (Example: corners=-0.739/-0.736/0.288/0.291)
  76.   center-mag=[Xctr/Yctr/Mag] An alternative method of entering corners.
  77.                With no parameters causes <B> command to output
  78.                'center-mag=' instead of corners.
  79.   maxiter=nnn           Maximum number of iterations (default = 150)
  80.   bailout=nnnn           Use this as the iteration bailout value (instead
  81.                of the default (4.0 for most fractal types)
  82.   initorbit=nnn/nnn       Sets the value used to initialize Mandelbrot orbits
  83.                to the given complex number (real and imag parts)
  84.   orbitdelay=nn           Slows up the display of orbits (by nn/10000 sec)
  85.   initorbit=pixel       Sets the value used to initialize Mandelbrot orbits
  86.                to the complex number corresponding to the screen
  87.                pixel. This is the default for most types.
  88.   periodicity=[no|show|nnn] Controls periodicity checking. 'no' turns checking
  89.                off; entering a number nnn controls the tightness
  90.                of checking (default 1, higher is more stringent)
  91.                'show' or a neg value colors 'caught' points white.
  92.   rseed=nnnnn           Random number seed, for reproducable Plasma Clouds
  93.   showdot=nn           Colors the current dot being calculated color nn.
  94. ~FF
  95. {Color Parameters}
  96.   inside=nnn|maxiter|zmag|bof60|bof61|epscr|star|per
  97.                Fractal interior color (inside=0 for black)
  98.   outside=nnn|iter|real|imag|mult|summ  Fractal exterior color options
  99.   map=filename           Use 'filename' as the default color map (vga/targa)
  100.   colors=@filename|colorspec Sets current image color map from file or spec,
  101.                vga or higher only
  102.   cyclerange=nnn/nnn       Range of colors to cycle (default 1/255)
  103.   cyclelimit=nnn       Color-cycler speed-limit (1 to 256, default = 55)
  104.   textcolors=aa/bb/cc/...  Set text screen colors
  105.   textcolors=mono       Set text screen colors to simple black and white
  106.   shortmap=yes           Uses the compact .map file format
  107.  
  108. {Doodad Parameters}
  109.   logmap=yes|old|nn       Yes maps logarithm of iteration to color. Old uses
  110.                pre vsn 14 logic. >1 compresses, <-1 for quadratic.
  111.   ranges=nn/nn/nn/...       Ranges of iteration values to map to colors
  112.   distest=nnn/nnn       Distance Estimator Method
  113.   decomp=nn           'Decomposition' toggle, value 2 to 256.
  114.   biomorph=nnn           Biomorph Coloring
  115.   potential=nn[/nn[/nn[/16bit]]]  Continuous Potential
  116.   invert=nn/nn/nn       Turns on inversion - turns images 'inside out'
  117. ~FF
  118.   finattract=yes       Look for finite attractor in julia types
  119.   exitnoask=yes           bypasses the final "are you sure?" exit screen
  120.  
  121. {Sound Parameters}
  122.   sound=off|x|y|z          Nobody ever plays with fractals at work, do they?
  123.                            x|y|z can be used to add sound to attractor
  124.                            fractals, the orbits command, and reading GIFs.
  125.   hertz=nnn                Base frequency for attractor sound effects
  126.  
  127. {File Parameters}
  128.   savename=filename       Save files using this name (instead of FRACT001)
  129.   overwrite=no|yes       Don't over-write existing files
  130.   savetime=nnn           Autosave image every nnn minutes of calculation
  131.   gif87a=yes           Save GIF files in the older GIF87a format (with
  132.                no FRACTINT extension blocks)
  133.   dither=yes           Dither color GIFs read into a b/w display.
  134.   parmfile=filename       File for <@> and <b> commands, default FRACTINT.PAR
  135.   formulafile=filename       File for type=formula, default FRACTINT.FRM
  136.   lfile=filename       File for type=lsystem, default FRACTINT.L
  137.   ifsfile=filename       File for type=ifs, default FRACTINT.IFS
  138.   orbitsave=yes        Causes IFS and orbit fractals orbit points to be
  139.                saved in the file ORBITS.RAW
  140. ~FF
  141.  
  142. {Video Parameters}
  143.   video=xxx           Begin with this video mode (Example: Video=F2)
  144.   askvideo=no           Skip the prompt for video mode when restoring files
  145.   adapter=hgc|cga|ega|egamono|mcga|vga
  146.                            Assume this (standard) video adapter is present
  147.   adapter=ATI|Everex|Trident|NCR|Video7|Genoa|Paradise|Chipstech|
  148.                            Tseng3000|Tseng4000|AheadA|AheadB|Oaktech
  149.                            Assume the named SuperVGA Chip set is present and
  150.                            enable its non-standard SuperVGA modes.
  151.   afi=yes                  Disables the register-compatible 8514/A logic
  152.                            and forces the use of the 8514/A API (HDILOAD)
  153.   textsafe=yes|no|bios|save  For use when images are not restored correctly on
  154.                return from a text display
  155.   exitmode=nn           Sets the bios-supported videomode to use upon exit
  156.                (if not mode 3) - nn is the mode in hexadecimal
  157.   viewwindows=xx[/xx[/yes|no[/nn[/nn]]]]
  158.                Set the reduction factor, final media aspect ratio,
  159.                crop starting coordinates (y/n), explicit x size,
  160.                and explicit y size
  161. ~FF
  162.  
  163. {Printer Parameters}
  164.   printer=type[/res[/lpt#[/-1]]]
  165.                Set the printer type, dots/inch, and port#
  166.                types: IBM, EPSON, CO (Star Micronix),
  167.                   HP (LaserJet), PA (Paintjet),
  168.                   PS (PostScript portrait), PSL (landscape)
  169.                port# 1-3 LPTn, 11-14 COMn, 21-22 direct parallel,
  170.                  31-32 direct serial
  171.   linefeed=crlf|lf|cr       Control characters to emit at end of each line
  172.   title=yes           Print a title with the output
  173.   printfile=filename       Print to specified file
  174.   epsf=1|2|3|...       Forces print to file; default filename fract001.eps,
  175.                forces PostScript mode
  176.   translate=yes|nnn       PostScript only; yes prints negative image;
  177.                >0 reduces image colors; <0 color reduce+negative
  178.   halftone=frq/angl/styl   PostScript: defines halftone screen
  179.   halftone=r/g/b       PaintJet: contrast adjustment
  180.   comport=port/baud/opts   COM port initialization. Port=1,2,3,etc.
  181.                baud=115,150,300,600,1200,2400,4800,9600
  182.                options 7,8 | 1,2 | e,n,o (any order)
  183.                Example: comport=1/9600/n71
  184. ~FF
  185.   colorps=yes|no           Enable or Disable the color postscript extensions
  186.   rleps=yes|no             Enable or Disable the postscript rle encoding
  187.  
  188. {3D Parameters}
  189.   3d=yes|overlay       Resets 3D to defaults, starts 3D mode. If overlay
  190.                specified, does not clear existing graphics screen
  191.   preview=yes           Turns on 3D 'preview' default mode
  192.   showbox=yes           Turns on 3D 'showbox' default mode
  193.   sphere=yes           Turns on 3D sphere mode
  194.   coarse=nnn           Sets Preview 'coarseness' default value
  195.   stereo=nnn           Sets Stereo (R/B 3D) option:  0 = none,
  196.                1 = alternate, 2 = superimpose, 3 = photo
  197.   ray=nnn           selects raytrace output file format
  198.   brief=yes           selects brief or verbose file for DKB output
  199.  
  200.   interocular=nnn       Sets 3D Interocular distance default value
  201.   converge=nnn           Sets 3D Convergence default value
  202.   crop=nnn/nnn/nnn/nnn       Sets 3D red-left, red-right, blue-left,
  203.                and blue-right cropping default valuess
  204.   bright=nnn/nnn       Sets 3D red and blue brightness defaults,
  205.  
  206.   longitude=nn/nn       Longitude minumim and maximum
  207.   latitude=nn/nn       Latitude minimum and maximum
  208.   radius=nn           Radius scale factor
  209.   rotation=nn[/nn[/nn]]    Rotation abount x,y, and z axes
  210.   scalexyz=nn/nn/nn       X, Y, and Z scale factors
  211.   roughness=nn           Same as Z scale factor
  212.   waterline=nn           Colors this number and below will be 'inside' color
  213.   filltype=nn           3D filltype
  214.   perspective=nn       Perspective viewer distance (100 is at the edge)
  215.   xyshift=nn/nn        Shift image in x & y directions (alters viewpoint)
  216.   lightsource=nn/nn/nn       The coordinates of the light source vector
  217.   smoothing=nn           Smooths rough images in light source mode
  218.   transparent=mm/nn       Sets colors 'mm' to 'nn as transparent
  219.   xyadjust=nnn/nnn       Sets 3D X and Y adjustment defaults,
  220.   randomize=nnn        smoothes 3d color transitions between elevations
  221.   fullcolor=yes        allows creation of full color .TGA image with
  222.                light source fill types
  223.   ambient=nnn           sets depth of shadows and contrast when using
  224.                light source fill types
  225.   haze=nnn           sets haze for distant objects if fullcolor=1
  226.   lightname=filename       fullcolor output file name, default FRACT001.TGA
  227. ;
  228. ;
  229. ~Topic=Introduction to Parameters
  230.  
  231. Fractint accepts command-line parameters that allow you to start it with a
  232. particular video mode, fractal type, starting coordinates, and just about
  233. every other parameter and option.
  234.  
  235. These parameters can also be specified in a SSTOOLS.INI file, to set them
  236. every time you run Fractint.
  237.  
  238. They can also be specified as named groups in a .PAR (parameter) file
  239. which you can then call up while running Fractint by using the <@>
  240. command.
  241.  
  242. In all three cases (DOS command line, SSTOOLS.INI, and parameter file) the
  243. parameters use the same syntax, usually a series of keyword=value commands
  244. like SOUND=OFF.  Each parameter is described in detail in subsequent
  245. sections.
  246. ;
  247. ;
  248. ~Topic=Using the DOS Command Line
  249.  
  250. You can specify parameters when you start Fractint from DOS by using a
  251. command like:
  252.  
  253.     FRACTINT SOUND=OFF FILENAME=MYIMAGE.GIF
  254.  
  255. The individual parameters are separated by one or more spaces (an
  256. parameter itself may not include spaces). Upper or lower case may be
  257. used, and parameters can be in any order.
  258.  
  259. Since DOS commands are limited to 128 characters, Fractint has a special
  260. command you can use when you have a lot of startup parameters (or have a
  261. set of parameters you use frequently):
  262.  
  263.     FRACTINT @MYFILE
  264.  
  265. When @filename is specified on the command line, Fractint reads parameters
  266. from the specified file as if they were keyed on the command line.  You
  267. can create the file with a text editor, putting one "keyword=value"
  268. parameter on each line.
  269. ;
  270. ;
  271. ~Topic=Setting Defaults (SSTOOLS.INI File)
  272. Every time Fractint runs, it searches the current directory, and then the
  273. directories in your DOS PATH, for a file named SSTOOLS.INI.  If it finds
  274. this file, it begins by reading parameters from it.  This file is useful
  275. for setting parameters you always want, such as those defining your
  276. printer setup.
  277.  
  278. SSTOOLS.INI is divided into sections belonging to particular programs.
  279. Each section begins with a label in brackets. Fractint looks for the label
  280. [fractint], and ignores any lines it finds in the file belonging to any
  281. other label. If an SSTOOLS.INI file looks like this:
  282.  
  283.   [fractint]\
  284.   sound=off     ; (for home use only)\
  285.   printer=hp     ; my printer is a LaserJet\
  286.   inside=0     ; using "traditional" black\
  287.   [startrek]\
  288.   warp=9.5     ; Captain, I dinna think the engines can take it!\
  289.  
  290. Fractint will use only the second, third, and fourth lines of the file.
  291. (Why use a convention like that when Fractint is the only program you know
  292. of that uses an SSTOOLS.INI file?  Because there are other programs (such
  293. as Lee Crocker's PICLAB) that now use the same file, and there may one day
  294. be other, sister programs to Fractint using that file.)
  295. ;
  296. ;
  297. ~Topic=Parameter Files and the <@> Command
  298.  
  299. You can change parameters on-the-fly while running Fractint by using the
  300. <@> command and a parameter file. Parameter files contain named groups of
  301. parameters, looking something like this:
  302.  
  303.   quickdraw \{        ; a set of parameters named quickdraw\
  304.      maxiter=150\
  305.      float=no\
  306.      }\
  307.   slowdraw \{        ; another set of parameters\
  308.      maxiter=2000\
  309.      float=yes\
  310.      }\
  311.  
  312. If you use the <@> command and select a parameter file containing the
  313. above example, Fractint will show two choices: quickdraw and slowdraw. You
  314. move the cursor to highlight one of the choices and press <Enter> to set
  315. the parameters specified in the file by that choice.
  316.  
  317. The default parameter file name is FRACTINT.PAR. A different file can be
  318. selected with the "parmfile=" option, or by using <@> and then hitting
  319. <F6>.
  320.  
  321. You can create parameter files with a text editor, or for some uses, by
  322. using the <B> command. Parameter files can be used in a number of ways,
  323. some examples:
  324.  
  325.   o To save the parameters for a favorite image. Fractint can do this for
  326.     you with the <B> command.
  327.  
  328.   o To save favorite sets of 3D transformation parameters. Fractint can do
  329.     this for you with the <B> command.
  330.  
  331.   o To set up different sets of parameters you use occasionally. For
  332.     instance, if you have two printers, you might want to set up a group
  333.     of parameters describing each.
  334.  
  335.   o To save image parameters for later use in batch mode - see
  336.     {Batch Mode}.
  337.  
  338. See {"Parameter Save/Restore Commands"} for details about the <@> and
  339. <B> commands.
  340. ;
  341. ;
  342. ~Topic=General Parameter Syntax
  343.  
  344. Parameters must be separated by one or more spaces.
  345.  
  346. Upper and lower case can be used in keywords and values.
  347.  
  348. Anything on a line following a ; (semi-colon) is ignored, i.e. is a
  349. comment.
  350.  
  351. In parameter files and SSTOOLS.INI:\
  352.   o Individual parameters can be entered on separate lines.\
  353.   o Long values can be split onto multiple lines by ending a line with a \\
  354.     (backslash) - leading spaces on the following line are ignored, the
  355.     information on the next line from the first non-blank character onward
  356.     is appended to the prior line.
  357.  
  358. Some terminology:\
  359.   KEYWORD=nnn           enter a number in place of "nnn"\
  360.   KEYWORD=[filename]       you supply filename\
  361.   KEYWORD=yes|no|whatever  choose one of "yes", "no", or "whatever"\
  362.   KEYWORD=1st[/2nd[/3rd]]  the slash-separated parameters "2nd" and
  363.                "3rd" are optional
  364. ;
  365. ;
  366. ~Topic=Startup Parameters
  367.  
  368. @FILENAME\
  369. Causes Fractint to read "filename" for parameters. When it finishes, it
  370. resumes reading its own command line -- i.e., "FRACTINT MAXITER=250
  371. @MYFILE PASSES=1" is legal. This option is only valid on the DOS command
  372. line, as Fractint is not clever enough to deal with multiple indirection.
  373.  
  374. @FILENAME/GROUPNAME\
  375. Like @FILENAME, but reads a named group of parameters from a parameter
  376. file.  See {"Parameter Files and the <@> Command"}.
  377.  
  378. FILENAME=[name]\
  379. Causes Fractint to read the named file, which must either have been saved
  380. from an earlier Fractint session or be a generic GIF file, and use that as
  381. the starting point, bypassing the initial information screens. The
  382. filetype is optional and defaults to .GIF. Non-Fractint GIF files are
  383. restored as fractal type "plasma".\
  384. On the DOS command line you may omit FILENAME= and just give the file name.
  385.  
  386. BATCH=yes\
  387. See {Batch Mode}.
  388.  
  389. AUTOKEY=play|record\
  390. Specifying "play" runs Fractint in playback mode - keystrokes are read
  391. from the autokey file (see next parameter) and interpreted as if they're
  392. being entered from the keyboard.\
  393. Specifying "record" runs in recording mode - all keystrokes are recorded
  394. in the autokey file.\
  395. See also {Autokey Mode}.
  396.  
  397. AUTOKEYNAME=[filename]\
  398. Specifies the file name to be used in autokey mode. The default file name
  399. is AUTO.KEY.
  400.  
  401. FPU=387|IIT|NOIIT\
  402. This parameter is useful if you have an unusual coprocessor chip. If you
  403. have a 80287 replacement chip with full 80387 functionality use "FPU=387"
  404. to inform Fractint to take advantage of those extra 387 instructions.
  405. If you have the IIT fpu, but don't have IIT's 'f4x4int.com' TSR loaded,
  406. use "FPU=IIT" to force Fractint to use that chip's matrix multiplication
  407. routine automatically to speed up 3-D transformations (if you have an IIT
  408. fpu and have that TSR loaded, Fractint will auto-detect the presence of
  409. the fpu and TSR and use its extra capabilities automatically).
  410. Since all IIT chips support 80387 instructions, enabling the IIT code also
  411. enables Fractint's use of all 387 instructions.
  412. Setting "FPU=NOIIT" disables Fractint's IIT Auto-detect capability.
  413. Warning: multi-tasking operating systems such as Windows and DesQView
  414. don't automatically save the IIT chip extra registers, so running two
  415. programs at once that both use the IIT's matrix multiply feature but
  416. don't use the handshaking provided by that 'f4x4int.com' program,
  417. errors will result.
  418.  
  419. MAKEDOC[=filename]\
  420. Create Fractint documentation file (for printing or viewing with a text
  421. editor) and then return to DOS.  Filename defaults to FRACTINT.DOC.
  422. There's also a function in Fractint's online help which can be used to
  423. produce the documentation file -
  424. ~Doc-
  425. see {Printing Fractint Documentation}.
  426. ~Doc+,Online-
  427. use "Printing Fractint Documentation" from the main help index.
  428. ~Online+
  429. ;
  430. ;
  431. ~Topic=Calculation Mode Parameters
  432.  
  433. PASSES=1|2|guess|btm|tesseral\
  434. Selects single-pass, dual-pass, solid-Guessing mode, Boundary Tracing,
  435. or the Tesseral algorithm.  See {Drawing Method}.
  436.  
  437. FILLCOLOR=normal|<nnn>\
  438. Sets a color to be used for block fill by Boundary Tracing and Tesseral
  439. algorithms.  See {Drawing Method}.
  440.  
  441. FLOAT=yes\
  442. Most fractal types have both a fast integer math and a floating point
  443. version. The faster, but possibly less accurate, integer version is the
  444. default. If you have a new 80486 or other fast machine with a math
  445. coprocessor, or if you are using the continuous potential option (which
  446. looks best with high bailout values not possible with our integer math
  447. implementation), you may prefer to use floating point. Just add
  448. "float=yes" to the command line to do so.
  449. Also see {"Limitations of Integer Math (And How We Cope)"}.
  450.  
  451. SYMMETRY=xxx\
  452. Forces symmetry to None, Xaxis, Yaxis, XYaxis, Origin, or Pi symmetry.
  453. Useful for debugging.
  454. ;
  455. ;
  456. ~Topic=Fractal Type Parameters
  457.  
  458. TYPE=[name]\
  459. Selects the fractal type to calculate. The default is type "mandel".
  460.  
  461. PARAMS=n/n/n/n...\
  462. Set optional (required, for some fractal types) values used in the
  463. calculations. These numbers typically represent the real and imaginary
  464. portions of some startup value, and are described in detail as needed in
  465. {Fractal Types}.\
  466. (Example: FRACTINT TYPE=julia PARAMS=-0.48/0.626 would wait at the opening
  467. screen for you to select a video mode, but then proceed straight to the
  468. Julia set for the stated x (real) and y (imaginary) coordinates.)
  469.  
  470. FUNCTION=[fn1[/fn2[/fn3[/fn4]]]]\
  471. Allows setting variable functions found in some fractal type formulae.
  472. Possible values are sin, cos, tan, cotan, sinh, cosh, tanh, cotanh, exp,
  473. log, sqr, recip (i.e. 1/z), ident (i.e. identity), and cosxx (cos with
  474. a pre version 16 bug).
  475.  
  476. FORMULANAME=[formulaname]\
  477. Specifies the default formula name for type=formula fractals.  (I.e. the
  478. name of a formula defined in the FORMULAFILE.) Required if you want to
  479. generate one of these fractal types in batch mode, as this is the only way
  480. to specify a formula name in that case.
  481.  
  482. LNAME=[lsystemname]\
  483. Specifies the default L-System name. (I.e. the name of an entry in the
  484. LFILE.) Required if you want to generate one of these fractal types in
  485. batch mode, as this is the only way to specify an L-System name in that
  486. case.
  487.  
  488. IFS=[ifsname]\
  489. Specifies the default IFS name. (I.e. the name of an entry in the
  490. IFSFILE.) Required if you want to generate one of these fractal types in
  491. batch mode, as this is the only way to specify an IFS name in that case.
  492. ;
  493. ;
  494. ~Topic=Image Calculation Parameters
  495. MAXITER=nnn\
  496. Reset the iteration maximum (the number of iterations at which the program
  497. gives up and says 'OK, this point seems to be part of the set in question
  498. and should be colored [insidecolor]') from the default 150. Values range
  499. from 10 to 32000 (super-high iteration limits like 30000 are useful when
  500. using logarithmic palettes).  See {The Mandelbrot Set} for a description
  501. of the iteration method of calculating fractals.\
  502. "maxiter=" can also be used to adjust the number of orbits plotted for
  503. 3D "attractor" fractal types such as lorenz3d and kamtorus.
  504.  
  505. CORNERS=xmin/xmax/ymin/ymax[/x3rd/y3rd]\
  506. Example: corners=-0.739/-0.736/0.288/0.291\
  507. Begin with these coordinates as the range of x and y coordinates, rather
  508. than the default values of (for type=mandel) -2.0/2.0/-1.5/1.5. When you
  509. specify four values (the usual case), this defines a rectangle: x-
  510. coordinates are mapped to the screen, left to right, from xmin to xmax, y-
  511. coordinates are mapped to the screen, bottom to top, from ymin to ymax.
  512. Six parameters can be used to describe any rotated or stretched
  513. parallelogram:    (xmin,ymax) are the coordinates used for the top-left
  514. corner of the screen, (xmax,ymin) for the bottom-right corner, and
  515. (x3rd,y3rd) for the bottom-left.
  516.  
  517. CENTER-MAG=[Xctr/Yctr/Mag]\
  518. This is an alternative way to enter corners as a center point and a
  519. magnification that is popular with some fractal programs and publications.
  520. Entering just "CENTER-MAG=" tells Fractint whether to use this form rather
  521. than corners when saving parameters with  the <B> command. The <TAB>
  522. status display shows the "corners" in both forms.  Note that an aspect
  523. ratio of 1.3333 is assumed; if you have altered the zoom box proportions
  524. or rotated the zoom box, this form can no longer be used.
  525.  
  526. BAILOUT=nnn\
  527. Over-rides the default bailout criterion for escape-time fractals. Can
  528. also be set from the parameters screen after selecting a fractal type.
  529. See description of bailout in {The Mandelbrot Set}.
  530.  
  531. RESET\
  532. Causes Fractint to reset all calculation related parameters to their
  533. default values. Non-calculation parameters such as "printer=", "sound=",
  534. and "savename=" are not affected. RESET should be specified at the start
  535. of each parameter file entry (used with the <@> command) which defines an
  536. image, so that the entry need not describe every possible parameter - when
  537. invoked, all parameters not specifically set by the entry will have
  538. predictable values (the defaults).
  539.  
  540. INITORBIT=pixel\
  541. INITORBIT=nnn/nnn\
  542. Allows control over the value used to begin each Mandelbrot-type orbit.
  543. "initorbit=pixel" is the default for most types; this command initializes
  544. the orbit to the complex number corresponding to the screen pixel. The
  545. command "initorbit=nnn/nnn" uses the entered value as the initializer. See
  546. the discussion of the {Mandellambda Sets} for more on this topic.
  547.  
  548. ORBITDELAY=<nn>\
  549. Slows up the display of orbits using the <o> command
  550. for folks with hot new computers. Units are in 1/10000 seconds per
  551. orbit point.  ORBITDELAY=10 therefore allows you to see each pixel's
  552. orbit point for about one millisecond. For best display of orbits,
  553. try passes=1 and a moderate resolution such as 320x200.  Note that
  554. the first time you press the 'o' key with the 'orbitdelay' function
  555. active, your computer will pause for a half-second or so to calibrate
  556. a high-resolution timer.        
  557.  
  558. PERIODICITY=no|show|nnn\
  559. Controls periodicity checking (see {Periodicity Logic}).
  560. "no" turns it off, "show" lets
  561. you see which pixels were painted as "inside" due to being caught
  562. by periodicity.  Specifying a number causes a more conservative
  563. periodicity test (each increase of 1 divides test tolerance by 2).
  564. Entering a negative number lets you turn on "show" with that number. Type
  565. lambdafn function=exp needs periodicity turned off to be accurate -- there
  566. may be other cases.
  567.  
  568. RSEED=nnnn\
  569. The initial random-number "seed" for plasma clouds is taken from your PC's
  570. internal clock-timer. This argument forces a value (which you can see in
  571. the <Tab> display), and allows you to reproduce plasma clouds. A detailed
  572. discussion of why a TRULY random number may be impossible to define, let
  573. alone generate, will have to wait for "FRACTINT: The 3-MB Doc File."
  574.  
  575. SHOWDOT=<nn>\
  576. Colors the pixel being calculated color <nn>. Useful for very slow
  577. fractals for showing you the calculation status.
  578. ;
  579. ;
  580. ~Topic=Color Parameters
  581. INSIDE=nnn|bof60|bof61|zmag|attractor|epscross|startrail|period\
  582. Set the color of the interior: for
  583. example, "inside=0" makes the M-set "lake" a stylish basic black. A setting of
  584. -1 makes inside=maxiter. Three more options reveal hidden structure inside the
  585. lake.  Inside=bof60 and inside=bof61, are named after the figures on pages 60
  586. and 61 of "Beauty of Fractals".  See {Inside=bof60|bof61|zmag|period}
  587. for a brilliant explanation of what these do!
  588.  
  589. Inside=zmag is a method of coloring based on the magnitude of Z after the
  590. maximum iterations have been reached.  The affect along the edges of the
  591. Mandelbrot is like thin-metal welded sculpture.
  592.  
  593. Inside=epscross colors pixels green or yellow according to whether their 
  594. orbits swing close to the Y-axis or X-axis, respectively. Inside=starcross
  595. has a coloring scheme based on clusters of points in the orbits. Best with
  596. outside=<nnn>. For more information, see {Inside=epscross|startrail}.
  597.  
  598. Inside=period colors pixels according to the period of their eventual orbit.
  599.  
  600. Note that the "Look for finite attractor" option on the <Y> options screen
  601. will override the selected inside option if an attractor is found - see
  602. {Finite Attractors}.
  603.  
  604. OUTSIDE=nnn|iter|real|imag|summ|mult\
  605. The classic method of coloring outside
  606. the fractal is to color according to how many iterations were required before
  607. Z reached the bailout value, usually 4. This is the method used when
  608. OUTSIDE=iter.
  609.  
  610. However, when Z reaches bailout the real and imaginary components can be at
  611. very diferent values.  OUTSIDE=real and OUTSIDE=imag color using the iteration
  612. value plus the real or imaginary values.  OUTSIDE=summ uses the sum of all
  613. these values.  These options can give a startling 3d quality to otherwise flat
  614. images and can change some boring images to wonderful ones. OUTSIDE=mult
  615. colors by multiplying the iteration by real divided by imaginary. There was no
  616. mathematical reason for this, it just seemed like a good idea.
  617.  
  618. Outside=nnn sets the color of the exterior to some number of your choosing:
  619. for example, "OUTSIDE=1" makes all points not INSIDE the fractal set to color
  620. 1 (blue). Note that defining an OUTSIDE color forces any image to be a
  621. two-color one: either a point is INSIDE the set, or it's OUTSIDE it.
  622.  
  623. MAP=[filename]\
  624. Reads in a replacement color map from [filename]. This map replaces the
  625. default color map of your video adapter. Requires a VGA or higher adapter.
  626. The difference
  627. between this argument and an alternate map read in via <L> in color-
  628. command mode is that this one applies to the entire run.
  629. See {Palette Maps}.
  630.  
  631. COLORS=@filename|colorspecification\
  632. Sets colors for the current image, like the <L> function in color cycling
  633. and palette editing modes. Unlike the MAP= parameter, colors set with
  634. COLORS= do not replace the default - when you next select a new video
  635. mode, colors will revert to their defaults.\
  636. COLORS=@filename tells Fractint to use a color map file named "filename".
  637. See {Palette Maps}.\
  638. COLORS=colorspecification specifies the colors directly. The value of
  639. "colorspecification" is rather long (768 characters for 256 color modes),
  640. and its syntax is not documented here. This form of the COLORS= command is
  641. not intended for manual use - it exists for use by the <B> command when
  642. saving the description of a nice image.
  643.  
  644. CYCLERANGE=nnn/nnn\
  645. Sets the range of color numbers to be animated during color cycling.  The
  646. default is 1/255, i.e. just color number 0 (usually black) is not cycled.
  647.  
  648. CYCLELIMIT=nnn\
  649. Sets the speed of color cycling. Technically, the number of DAC registers
  650. updated during a single vertical refresh cycle. Legal values are 1 - 256,
  651. default is 55.
  652.  
  653. TEXTCOLORS=mono\
  654. Set text screen colors to simple black and white.
  655.  
  656. TEXTCOLORS=aa/bb/cc/...\
  657. Set text screen colors. Omit any value to use the default (e.g.
  658. textcolors=////50 to set just the 5th value). Each value is a 2 digit
  659. hexadecimal value; 1st digit is background color (from 0 to 7), 2nd digit
  660. is foreground color (from 0 to F).\
  661. ~Format-
  662. Color values are:
  663.     0 black    8 gray
  664.     1 blue    9 light blue
  665.     2 green    A light green
  666.     3 cyan    B light cyan
  667.     4 red    C light red
  668.     5 magenta    D light magenta
  669.     6 brown    E yellow
  670.     7 white    F bright white
  671. 31 colors can be specified, their meanings are as follows:
  672. ~OnlineFF
  673.   heading:
  674.     1  Fractint version info
  675.     2  heading line development info (not used in released version)
  676.   help:
  677.     3  sub-heading
  678.     4  main text
  679.     5  instructions at bottom of screen
  680.     6  hotlink field
  681.     7  highlighted (current) hotlink
  682.   menu, selection boxes, parameter input boxes:
  683.     8  background around box and instructions at bottom
  684.     9  emphasized text outside box
  685.    10  low intensity information in box
  686.    11  medium intensity information in box
  687.    12  high intensity information in box (e.g. heading)
  688.    13  current keyin field
  689.    14  current keyin field when it is limited to one of n values
  690.    15  current choice in multiple choice list
  691.    16  speed key prompt in multiple choice list
  692.    17  speed key keyin in multiple choice list
  693.   general (tab key display, IFS parameters, "thinking" display):
  694.    18  high intensity information
  695.    19  medium intensity information
  696.    20  low intensity information
  697.    21  current keyin field
  698.   disk video:
  699.    22  background around box
  700.    23  high intensity information
  701.    24  low intensity information
  702.   diagnostic messages:
  703.    25  error
  704.    26  information
  705.   credits screen:
  706.    27  bottom lines
  707.    28  high intensity divider line
  708.    29  low intensity divider line
  709.    30  primary authors
  710.    31  contributing authors
  711. The default is
  712.    textcolors=1F/1A/2E/70/28/71/31/78/70/17/
  713.           1F/1E/2F/3F/5F/07/0D/71/70/78/0F/
  714.           70/0E/0F/4F/20/17/20/28/0F/07
  715. (In a real command file, all values must be on one line.)
  716. ~Format+
  717. ;
  718. ;
  719. ~Topic=Doodad Parameters
  720.  
  721. LOGMAP=yes|old|n\
  722. Selects a compressed relationship between escape-time iterations and
  723. palette colors.  See {"Logarithmic Palettes and Color Ranges"} for details.
  724.  
  725. RANGES=nn/nn/nn/...\
  726. Specifies ranges of escape-time iteration counts to be mapped to each
  727. color number.  See {"Logarithmic Palettes and Color Ranges"} for details.
  728.  
  729. DISTEST=nnn/nnn\
  730. A nonzero value in the first parameter enables the distance estimator
  731. method. The second parameter specifies the "width factor", defaults to 71.
  732. See {"Distance Estimator Method"} for details.
  733.  
  734. DECOMP=2|4|8|16|32|64|128|256\
  735. Invokes the corresponding decomposition coloring scheme.
  736. See {Decomposition} for details.
  737.  
  738. BIOMORPH=nnn\
  739. Turn on biomorph option; set affected pixels to color nnn.
  740. See {Biomorphs} for details.
  741.  
  742. POTENTIAL=maxcolor[/slope[/modulus[/16bit]]]\
  743. Enables the "continuous potential" coloring mode for all fractal types
  744. except plasma clouds, attractor types such as lorenz, and IFS. The four
  745. arguments define the maximum color value, the slope of the potential
  746. curve, the modulus "bailout" value, and whether 16 bit values are to be
  747. calculated.  Example: "POTENTIAL=240/2000/40/16bit". The Mandelbrot and
  748. Julia types ignore the modulus bailout value and use their own hardwired
  749. value of 4.0 instead.  See {Continuous Potential} for details.
  750.  
  751. INVERT=nn/nn/nn\
  752. Turns on inversion. The parameters are radius of inversion, x-coordinate
  753. of center, and y-coordinate of center. -1 as the first parameter sets the
  754. radius to 1/6 the smaller screen dimension; no x/y parameters defaults to
  755. center of screen. The values are displayed with the <Tab> command.
  756. See {Inversion} for details.
  757.  
  758. FINATTRACT=no|yes\
  759. Another option to show coloring inside some Julia "lakes" to show escape
  760. time to finite attractors. Works with lambda, magnet types, and possibly
  761. others.  See {Finite Attractors} for more information.
  762.  
  763. EXITNOASK=yes\
  764. This option forces Fractint to bypass the final "are you sure?" exit
  765. screen when the ESCAPE key is pressed from the main image-generation
  766. screen.  Added at the request of Ward Christensen.  It's his funeral <grin>.
  767. ;
  768. ;
  769. ~Topic=File Parameters
  770.  
  771. SAVENAME=[name]\
  772. Set the filename to use when you <S>ave a screen. The default filename is
  773. FRACT001. The .GIF extension is optional (Example: SAVENAME=myfile)
  774.  
  775. OVERWRITE=no|yes\
  776. Sets the savename overwrite flag (default is 'no'). If 'yes', saved files
  777. will over-write existing files from previous sessions; otherwise the
  778. automatic incrementing of FRACTnnn.GIF will find the first unused
  779. filename.
  780.  
  781. SAVETIME=nnn\
  782. Tells Fractint to automatically do a save every nnn minutes while a
  783. calculation is in progress.  This is mainly useful with long batches - see
  784. {Batch Mode}.
  785.  
  786. GIF87a=YES\
  787. Backward-compatibility switch to force creation of GIF files in the GIF87a
  788. format. As of version 14, Fractint defaults to the new GIF89a format which
  789. permits storage of fractal information within the format. GIF87a=YES is
  790. only needed if you wish to view Fractint images with a GIF decoder that
  791. cannot accept the newer format.  See {GIF Save File Format}.
  792.  
  793. DITHER=YES\
  794. Dither a color file into two colors for display on a b/w display.  This give
  795. a poor-quality display of gray levels.  Note that if you have a 2-color
  796. display, you can create a 256-color gif with disk video and then read it
  797. back in dithered.
  798.  
  799. PARMFILE=[parmfilename]\
  800. Specifies the default parameter file to be used by the <@> and <B>
  801. commands.  If not specified, the default is FRACTINT.PAR.
  802.  
  803. FORMULAFILE=[formulafilename]\
  804. Specifies the formula file for type=formula fractals (default is
  805. FRACTINT.FRM).    Handy if you want to generate one of these fractal types
  806. in batch mode.
  807.  
  808. LFILE=[lsystemfile]\
  809. Specifies the default L-System file for type=lsystem fractals (if not
  810. FRACTINT.L).
  811.  
  812. IFSFILE=[ifsfilename]\
  813. Specifies the default file for type=ifs fractals (default is
  814. FRACTINT.IFS).
  815.  
  816. FILENAME=[.suffix]\
  817. Sets the default file extension used for the <r> command.
  818. When this parameter is omitted, the
  819. default file mask shows .GIF and .POT files.  You might want to specify
  820. this parameter and the SAVENAME= parameter in your SSTOOLS.INI file if you
  821. keep your fractal images separate from other .GIF files by using a
  822. different suffix for them.
  823.  
  824. ORBITSAVE=yes\
  825. Causes the file ORBITS.RAW to be opened and the points generated by orbit
  826. fractals or IFS fractals to be saved in a raw format. This file can be read
  827. by the Acrospin program which can rotate and scale the image rapidly in
  828. response to cursor-key commands. The filename ORBITS.RAW is fixed and will
  829. be overwritten each time a new fractal is generated with this option.\
  830. (see {Barnsley IFS Fractals} {Orbit Fractals} {=@ACROSPIN Acrospin});
  831. ;
  832. ~Topic=Video Parameters
  833.  
  834. VIDEO=xxx\
  835. Set the initial video mode (and bypass the informational screens). Handy
  836. for batch runs. (Example: VIDEO=F4 for IBM 16-color VGA.)
  837. You can obtain the current VIDEO= values (key assignments) from the
  838. "select video mode" screens inside Fractint. If you want to do a batch run
  839. with a video mode which isn't currently assigned to a key, you'll have to
  840. modify the key assignments - see {"Video Mode Function Keys"}.
  841.  
  842. ASKVIDEO=yes|no\
  843. If "no," this eliminates the prompt asking you if a file to be restored is
  844. OK for your current video hardware.\
  845. WARNING: every version of Fractint so far has had a bigger, better, but
  846. shuffled-around video table. Since calling for a mode your hardware
  847. doesn't support can leave your system in limbo, be careful about leaving
  848. the above two parameters in a command file to be used with future versions
  849. of Fractint, particularly for the super-VGA modes.
  850.  
  851. ADAPTER=hgc|cga|ega|egamono|mcga|vga|ATI|Everex|Trident|NCR|Video7|Genoa|
  852.         Paradise|Chipstech|Tseng3000|Tseng4000|AheadA|AheadB|Oaktech\
  853. Bypasses Fractint's internal video autodetect logic and assumes that the
  854. specified kind of adapter is present. Use this parameter only if you
  855. encounter video problems without it.  Specifying adapter=vga with an SVGA
  856. adapter will make its extended modes unusable with Fractint.  All of the
  857. options after the "VGA" option specify specific SuperVGA chipsets which
  858. are capable of video resolutions higher than that of a "vanilla" VGA adapter.
  859. Note that Fractint cares about the Chipset your adapter uses internally,
  860. not the name of the company that sold it to you.
  861.  
  862. VESADETECT=yes|no\
  863. Specify no to bypass VESA video detection logic. Try this if you encounter
  864. video problems with a VESA compliant video adapter or driver.
  865.  
  866. AFI=yes|8514|no\
  867. Normally, when you attempt to use an 8514/A-specific video mode, Fractint
  868. first attempts to detect the presence of an 8514/A register-compatible
  869. adapter.  If it fails to find one, it then attempts to detect the presence
  870. of an 8514/A-compatible API (IE, IBM's HDILOAD or its equivalent).  
  871. Fractint then uses either its register-compatible or its API-compatible
  872. video logic based on the results of those tests.  If you have an
  873. "8514/A-compatible" video adapter that passes Fractint's
  874. register-compatible detection logic but doesn't work correctly with
  875. Fractint's register-compatible video logic, setting "afi=yes" will
  876. force Fractint to bypass the register-compatible code and look only for
  877. the API interface.
  878.  
  879. TEXTSAFE=yes|no|bios|save\
  880. When you switch from a graphics image to text mode (e.g. when you use <F1>
  881. while a fractal is on display), Fractint remembers the graphics image, and
  882. restores it when you return from the text mode.
  883. This should be no big deal - there are a number of well-defined ways
  884. Fractint could do this which *should* work on any video adapter.  They
  885. don't - every fast approach we've tried runs into a bug on one video
  886. adapter or another.  So, we've implemented a fast way which works on most
  887. adapters in most modes as the default, and added this parameter for use
  888. when the default approach doesn't work.\
  889. If you experience the following problems, please fool around with this
  890. parameter to try to fix the problem:\
  891.   o Garbled image, or lines or dashes on image, when returning to image
  892.     after going to menu, <tab> display, or help.\
  893.   o Blank screen when starting Fractint.\
  894. The problems most often occur in higher resolution modes. We have not
  895. encountered them at all in modes under 320x200x256 - for those modes
  896. Fractint always uses a fast image save/restore approach.\
  897. Textsafe options:\
  898.   yes: This is the default. When switching to/from graphics, Fractint
  899.     saves just that part of video memory which EGA/VGA adapters are
  900.     supposed to modify during the mode changes.
  901.   no: This forces use of monochrome 640x200x2 mode for text displays (when
  902.     there is a high resolution graphics image to be saved.) This choice is
  903.     fast but uses chunky and colorless characters. If it turns out to be
  904.     the best choice for you, you might want to also specify
  905.     "textcolors=mono" for a more consistent appearance in text screens.
  906.   bios: This saves memory in the same way as textsafe=yes, but uses the
  907.     adapter's BIOS routines to save/restore the graphics state.  This
  908.     approach is fast and ought to work on all adapters. Sadly, we've found
  909.     that very few adapters implement this function perfectly.
  910.   save: This is the last choice to try. It should work on all adapters in
  911.     all modes but it is slow. It tells Fractint to save/restore the entire
  912.     image. Expanded or extended memory is used for the save if you have
  913.     enough available; otherwise a temporary disk file is used. The speed
  914.     of textsafe=save will be acceptable on some machines but not others.
  915.     The speed depends on:\
  916.       o Cpu and video adapter speed.\
  917.       o Whether enough expanded or extended memory is available.\
  918.       o Video mode of image being remembered. A few special modes are
  919.     *very* slow compared to the rest. The slow ones are: 2 and 4 color
  920.     modes with resolution higher than 640x480; custom modes for ATI
  921.     EGA Wonder, Paradise EGA-480, STB, Compaq portable 386, AT&T 6300,
  922.     and roll-your-own video modes implemented with customized
  923.     "yourvid.c" code.
  924. If you want to tune Fractint to use different "textsafe" options for
  925. different video modes, see {"Customized Video Modes\, FRACTINT.CFG"}.
  926. (E.g. you might
  927. want to use the slower textsafe=save approach just for a few high-
  928. resolution modes which have problems with textsafe=yes.)
  929.  
  930. EXITMODE=nn\
  931. Sets the bios-supported videomode to use upon exit to the specified value.
  932. nn is in hexadecimal.  The default is 3, which resets to 80x25 color text
  933. mode on exit. With Hercules Graphics Cards, and with monochrome EGA
  934. systems, the exit mode is always 7 and is unaffected by this parameter.
  935.  
  936. TPLUS=yes|no\
  937. For TARGA+ adapters. Setting this to 'no' pretends a TARGA+ is NOT
  938. installed.
  939.  
  940. NONINTERLACED=yes|no\
  941. For TARGA+ adapters. Setting this to 'yes' will configure the adapter to a
  942. non-interlaced mode whenever possible.    It should only be used with a
  943. multisynch monitor. The default is no, i.e. interlaced.
  944.  
  945. MAXCOLORRES=8|16|24\
  946. For TARGA+ adapters. This determines the number of bits to use for color
  947. resolution.  8 bit color is equivalent to VGA color resolution. The 16 and
  948. 24 bit color resolutions are true color video modes which are not yet
  949. supported by Fractint but are hopefully coming soon.
  950.  
  951. PIXELZOOM=0|1|2|3\
  952. For TARGA+ adapters. Lowers the video mode resolution by powers of 2. For
  953. example, the 320x200 video resolution on the TARGA+ is actually the
  954. 640x400 video mode with a pixel zoom of 1.  Using the 640x400 video mode
  955. with a zoom of 3 would lower the resolution by 8, which is 2 raised to the
  956. 3rd power, for a full screen resolution of 80x50 pixels.
  957.  
  958. VIEWWINDOWS=xx[/xx[/yes|no[/nn[/nn]]]]
  959. Set the reduction factor, final media aspect ratio, crop starting
  960. coordinates (y/n), explicit x size, and explicit y size, see {"View Window"}.
  961. ;
  962. ;
  963. ~Topic=Sound Parameters
  964.  
  965. SOUND=off|x|y|z\
  966. We're all MUCH too busy to waste time with Fractint at work, and no doubt
  967. you are too, so "sound=off" is included only for use at home, to avoid
  968. waking the kids or your Significant Other, late at night. (By the way,
  969. didn't you tell yourself "just one more zoom on LambdaSine" an hour ago?)
  970. Suggestions for a "boss" hot-key will be cheerfully ignored, as this
  971. sucker is getting big enough without including a spreadsheet screen too.
  972. The "sound=x/y/x" options are for the "attractor" fractals, like the
  973. Lorenz fractals - they play with the sound on your PC speaker as they are
  974. generating an image, based on the X or Y or Z co-ordinate they are
  975. displaying at the moment.  At the moment, "sound=x" (or y or z) really
  976. doesn't work very well when using an integer algorithm - try it with the
  977. floating-point toggle set, instead.
  978.  
  979. The scope of the sound command has been extended. You can now hear the
  980. sound of fractal orbits--just turn on sound from the command line or the
  981. <X> menu, fire up a fractal, and try the <O>rbits command. Use the
  982. orbitdelay=<nnn> command (also on the <X> menu) to dramatically alter
  983. the effect, which ranges from an unearthly scream to a series of discrete
  984. tones. Not recommended when people you have to live with are nearby!
  985. Remember, we don't promise that it will sound beautiful!
  986.  
  987. You can also "hear" any image that Fractint can decode; turn on sound
  988. before using <R> to read in a GIF file. We have no idea if this feature
  989. is useful. It was inspired by the comments of an on-line friend who is
  990. blind. We solicit feedback and suggestions from anyone who finds these
  991. sound features interesting or useful. The orbitdelay command also affects
  992. the sound of decoding images.
  993.  
  994. HERTZ=nnn\
  995. Adjusts the sound produced by the "sound=x/y/z" option.  Legal values are
  996. 200 through 10000.
  997. ;
  998. ;
  999. ~Topic=Printer Parameters
  1000.  
  1001. ~Doc-
  1002. General printer parameters are described below.\
  1003. Additional parameters for specific types of printers are described in:\
  1004.      {PostScript Parameters}\
  1005.      {PaintJet Parameters}\
  1006.      {Plotter Parameters}\
  1007.  
  1008. ~Doc+
  1009. PRINTER=type[/resolution[/port#]]\
  1010. Defines your printer setup. The SSTOOLS.INI file is a REAL handy place to
  1011. put this option, so that it's available whenever you have that sudden,
  1012. irresistible urge for hard copy.
  1013. ~Format-
  1014. Printer types:
  1015.   IB  IBM-compatible (default)
  1016.   EP  Epson-compatible
  1017.   HP  LaserJet
  1018.   CO  Star Micronics Color printer, supposedly Epson-color-compatible
  1019.   PA  Paintjet
  1020.   PS  PostScript
  1021.   PSL Postscript, landscape mode
  1022.   PL  Plotter using HP-GL
  1023. Resolution:
  1024.   In dots per inch.
  1025.   Epson/IBM: 60, 120, 240
  1026.   LaserJet: 75, 150, 300
  1027.   PaintJet: 90, 180
  1028.   PostScript: 10 through 600, or special value 0 to print full page to
  1029.   within about .4" of the edges (in portrait mode, width is full page and
  1030.   height is adjusted to 3:4 aspect ratio)
  1031.   Plotter: 1 to 10 for 1/Nth of page (e.g. 2 for 1/2 page)
  1032. Port:
  1033.   1, 2, 3 for LPT1-3 via BIOS
  1034.   11, 12, 13, 14 for COM1-4 via BIOS
  1035.   21, 22 for LPT1 or LPT2 using direct port access (faster when it works)
  1036.   31, 32 for COM1 or COM2 using direct port access
  1037. ~Format+
  1038.  
  1039. COMPORT=port/baud/options\
  1040. Serial printer port initialization.\
  1041. Port=1,2,3,etc.\
  1042. Baud=115,150,300,600,1200,2400,4800,9600\
  1043. Options: 7,8 | 1,2 | e,n,o (any order).\
  1044. Example: comport=1/9600/n81 for COM1 set to 9600, no parity, 8 bits per
  1045. character, 1 stop bit.
  1046.  
  1047. LINEFEED=crlf|lf|cr\
  1048. Specifies the control characters to emit at end of each line:  carriage
  1049. return and linefeed, just linefeed, or just carriage return.  The default
  1050. is crlf.
  1051.  
  1052. TITLE=yes\
  1053. If specified, title information is added to printouts.
  1054.  
  1055. PRINTFILE=filename\
  1056. Causes output data for the printer to be written to the named file on disk
  1057. instead of to a printer port. The filename is incremented by 1 each time
  1058. an image is printed - e.g. if the name is FRAC01.PRN, the second print
  1059. operation writes to FRAC02.PRN, etc. Existing files are not overwritten -
  1060. if the file exists, the filename is incremented to a new name.
  1061. ;
  1062. ;
  1063. ~Topic=PostScript Parameters
  1064.  
  1065. EPSF=1|2|3\
  1066. Forces print-to-file and PostScript. If PRINTFILE is not specified, the
  1067. default filename is FRACT001.EPS. The number determines how 'well-behaved'
  1068. a .EPS file is. 1 means by-the-book. 2 allows some EPS 'no-nos' like
  1069. settransfer and setscreen - BUT includes code that should make the code
  1070. still work without affecting the rest of the non-EPS document. 3 is a
  1071. free-for-all.
  1072.  
  1073. COLORPS=YES|NO - Enable or disable the color extensions.
  1074.  
  1075. RLEPS=YES|NO\
  1076. Enable or disable run length encoding of the PostScript file.  Run length
  1077. encoding will make the PostScript file much smaller, but it may take longer
  1078. to print.  The run length encoding code is based on pnmtops, which is
  1079. copyright (C) 1989 by Jef Poskanzer, and carries the following notice:
  1080. "Permission to use, copy, modify, and distribute this software and its
  1081. documentation for any purpose and without fee is hereby granted, provided
  1082. that the above copyright notice appear in all copies and that both that
  1083. copyright notice and this permission notice appear in supporting
  1084. documentation.  This software is provided "as is" without express or
  1085. implied warranty."
  1086.  
  1087. TRANSLATE=yes|-n|n\
  1088. Translate=yes prints the negative image of the fractal.
  1089. Translate=n reduces the image to that many colors. A negative value causes
  1090. a color reduction as well as a negative image.
  1091.  
  1092. HALFTONE=frq/ang/sty[/f/a/s/f/a/s/f/a/s]\
  1093. Tells the PostScript printer how to define its halftone screen. The first
  1094. value, frequency, defines the number of halftone lines per inch. The
  1095. second chooses the angle (in degrees) that the screen lies at. The third
  1096. option chooses the halftone 'spot' style. Good default frequencies are
  1097. between 60 and 80; Good default angles are 45 and 0; the default style is
  1098. 0. If the halftone= option is not specified, Fractint will print using the
  1099. printer's default halftone screen, which should have been already set to
  1100. do a fine job on the printer.
  1101.  
  1102. These are the only three used when colorps=no. When color PS printing is
  1103. being used, the other nine options specify the red, green, then blue
  1104. screens. A negative number in any of these places will cause it to use
  1105. the previous (or default) value for that parameter. NOTE: Especially when
  1106. using color, the built-in screens in the printer's ROM may be the best
  1107. choice for printing.
  1108. ~OnlineFF
  1109. The default values are as follows: halftone=45/45/1/45/75/1/45/15/1/45/0/1
  1110. and these will be used if Fractint's halftone is chosen over the printer's
  1111. built-in screen.
  1112. ~Format-
  1113.  
  1114. Current halftone styles:
  1115.     0 Dot
  1116.     1 Dot (Smoother)
  1117.     2 Dot (Inverted)
  1118.     3 Ring (Black)
  1119.     4 Ring (White)
  1120.     5 Triangle (Right)
  1121.     6 Triangle (Isosceles)
  1122.     7 Grid
  1123.     8 Diamond
  1124.     9 Line
  1125.    10 Microwaves
  1126.    11 Ellipse
  1127.    12 Rounded Box
  1128.    13 Custom
  1129.    14 Star
  1130.    15 Random
  1131.    16 Line (slightly different)
  1132. ~Format+
  1133. ~OnlineFF
  1134.  
  1135. A note on device-resolution black and white printing\
  1136. ----------------------------------------------------\
  1137.  
  1138. This mode of printing can now be done much more quickly, and takes a
  1139. lot less file space. Just set EPSF=0 PRINTER=PSx/nnn COLORPS=NO
  1140. RLEPS=YES TRANSLATE=m, where x is P or L for portrait/landscape, nnn is
  1141. your printer's resolution, m is 2 or -2 for positive or negative
  1142. printing respectively. This combination of parameters will print
  1143. exactly one printer pixel per each image pixel and it will keep the
  1144. proportions of the picture, if both your screen and printer have
  1145. square pixels (or the same pixel-aspect). Choose a proper (read large)
  1146. window size to fill as much of the paper as possible for the most
  1147. spectacular results.  2048 by 2048 is barely enough to fill the width
  1148. of a letter size page with 300 dpi printer resolution.  For higher
  1149. resolution printers, you will wish fractint supported larger window
  1150. sizes (hint, hint...). Bug reports and/or suggestions should be
  1151. forwarded to Yavuz Onder (post to sci.fractals, no e-mail yet).
  1152. ~OnlineFF
  1153.  
  1154. A word from the author (Scott Taylor)\
  1155. -------------------------------------\
  1156.  
  1157. Color PostScript printing is new to me. I don't even have a color printer to
  1158. test it on. (Don't want money. Want a Color PostScript printer!) The initial
  1159. tests seem to have worked. I am still testing and don't know whether or not
  1160. some sort of gamma correction will be needed. I'll have to wait and see about
  1161. that one.
  1162. ;
  1163. ;
  1164. ~Topic=PaintJet Parameters
  1165. Note that the pixels printed by the PaintJet are square.
  1166. Thus, a printout of an image
  1167. created in a video mode with a 4:3 pixel ratio (such as 640x480 or
  1168. 800x600) will come out matching the screen; other modes (such as 320x200)
  1169. will come out stretched.
  1170.  
  1171. Black and white images, or images using the 8 high resolution PaintJet
  1172. colors, come out very nicely.  Some images using the full spectrum of
  1173. PaintJet colors are very nice, some are disappointing.
  1174.  
  1175. When 180 dots per inch is selected (in PRINTER= command), high resolution
  1176. 8 color printing is done.  When 90 dpi is selected, low resolution
  1177. printing using the full 330 dithered color palette is done.  In both
  1178. cases, Fractint starts by finding the nearest color supported by the
  1179. PaintJet for each color in your image.    The translation is then
  1180. displayed (unless the current display mode is disk video).  This display
  1181. *should* be a fairly good match to what will be printed
  1182. - it won't be perfect most of the time but should give some idea
  1183. of how the output will look.  At this point you can <Enter> to go ahead
  1184. and print, <Esc> to cancel, or <k> to cancel and keep the
  1185. adjusted colors.
  1186.  
  1187. Note that you can use the color map PAINTJET.MAP to create images which
  1188. use the 8 high resolution colors available on the PaintJet.  Also, two
  1189. high-resolution disk video modes are available for creating full page
  1190. images.
  1191.  
  1192. If you find that the preview image seems very wrong (doesn't match what
  1193. actually gets printed) or think that Fractint could be doing a better job
  1194. of picking PaintJet colors to match your image's colors, you can try
  1195. playing with the following parameter.  Fair warning: this is a very
  1196. tricky business and you may find it a very frustrating business trying to
  1197. get it right.
  1198.  
  1199. HALFTONE=r/g/b\
  1200. (The parameter name is not appropriate - we appropriated a PostScript
  1201. parameter for double duty here.)\
  1202. This separately sets the "gamma" adjustment for each of the red, green,
  1203. and blue color components.  Think of "gamma" as being
  1204. like the contrast adjustment on your screen.  Higher gamma values for all
  1205. three components results in colors with more contrast being produced
  1206. on the printer.  Since each color component can have its gamma separately
  1207. adjusted, you can change the resulting color mix subtly (or drastically!)\
  1208. Each gamma value entered has one implied decimal digit.\
  1209. The default is "halftone=21/19/16", for red 2.1, green 1.9, and blue 1.6.
  1210. (A note from Pieter Branderhorst: I wrote this stuff to come out reasonably
  1211. on my monitor/printer.    I'm a bit suspicious of the guns on my monitor;
  1212. if the colors seem ridiculously wrong on your system you might start by
  1213. trying halftone=17/17/17.)
  1214. ;
  1215. ;
  1216. ~Topic=Plotter Parameters
  1217.  
  1218. Plotters which understand HP-GL commands are supported. To use a plotter,
  1219. draw a SMALL image (32x20 or 64x40) using the <v>iew screen options.  Put
  1220. a red pen in the first holder in the plotter, green in the second, blue in
  1221. the third.  Now press <P> to start plotting.  Now get a cup of coffee...
  1222. or two... or three.  It'll take a while to plot.  Experiment with
  1223. different resolutions, plot areas, plotstyles, and even change pens to
  1224. create weird-colored images.
  1225.  
  1226. PLOTSTYLE=0|1|2\
  1227. 0: 3 parallel lines (red/green/blue) are drawn for each pixel, arranged
  1228.   like "///".  Each bar is scaled according to the intensity of the
  1229.   corresponding color in the pixel.  Using different pen colors (e.g.
  1230.   blue, green, violet) can come out nicely.  The trick is to not tell
  1231.   anyone what color the bars are supposed to represent and they will
  1232.   accept these plotted colors because they do look nice...
  1233. 1: Same as 0, but the lines are also twisted.  This removes some of the
  1234.   'order' of the image which is a nice effect.  It also leaves more
  1235.   whitespace making the image much lighter, but colors such as yellow are
  1236.   actually visible.
  1237. 2: Color lines are at the same angle and overlap each other.  This type
  1238.   has the most whitespace.  Quality improves as you increase the number of
  1239.   pixels squeezed into the same size on the plotter.
  1240. ;
  1241. ;
  1242. ~Topic=3D Parameters
  1243.  
  1244. To stay out of trouble, specify all the 3D parameters, even if you want to
  1245. use what you think are the default values. It takes a little practice to
  1246. learn what the default values really are. The best way to create a set of
  1247. parameters is to use the <B> command on an image you like and then use an
  1248. editor to modify the resulting parameter file.
  1249.  
  1250. 3D=Yes\
  1251. 3D=Overlay\
  1252. Resets all 3d parameters to default values. If FILENAME= is given, forces
  1253. a restore to be performed in 3D mode (handy when used with 'batch=yes' for 
  1254. batch-mode 3D images). If specified, 3D=Yes should come before any other 
  1255. 3d parameters on the command line or in a parameter file entry. The form
  1256. 3D=Overlay is identical except that the previous graphics screen is not
  1257. cleared, as with the <#> (<shift-3> on some keyboards) overlay command. 
  1258. Useful for building parameter files that use the 3D overlay feature.\
  1259.  
  1260. The options below override the 3D defaults:
  1261. ~Format-
  1262. PREVIEW=yes           Turns on 3D 'preview' default mode
  1263. SHOWBOX=yes           Turns on 3D 'showbox' default mode
  1264. COARSE=nn           Sets Preview 'coarseness' default value
  1265. SPHERE=yes           Turns on spherical projection mode
  1266. STEREO=n           Selects the type of stereo image creation
  1267. RAY=nnn            selects raytrace output file format
  1268. BRIEF=yes           selects brief or verbose file for DKB output
  1269.  
  1270. INTEROCULAR=nn           Sets the interocular distance for stereo
  1271. CONVERGE=nn           Determines the overall image separation
  1272. CROP=nn/nn/nn/nn       Trims the edges off stereo pairs
  1273. BRIGHT=nn/nn           Compensates funny glasses filter parameters
  1274. LONGITUDE=nn/nn        Longitude minimum and maximum
  1275. LATITUDE=nn/nn           Latitude minimum and maximum
  1276. RADIUS=nn           Radius scale factor
  1277. ROTATION=nn[/nn[/nn]]       Rotation about x,y, and z axes
  1278. SCALEZYZ=nn/nn/nn       X,y,and z scale factors
  1279. ROUGHNESS=nn           Same as z scale factor
  1280. WATERLINE=nn           Colors nn and below will be "inside" color
  1281. FILLTYPE=nn           3D filltype
  1282. PERSPECTIVE=nn           Perspective distance
  1283. XYSHIFT=nn/nn           Shift image in x and y directions with
  1284.                 perspective
  1285. LIGHTSOURCE=nn/nn/nn       Coordinates for light-source vector
  1286. SMOOTHING=nn           Smooths images in light-source fill modes
  1287. TRANSPARENT=min/max       Defines a range of colors to be treated as
  1288.                 "transparent" when <#>Overlaying 3D images.
  1289. XYADJUST=nn/nn           This shifts the image in the x/y dir without
  1290.                 perspective
  1291. ~Format+
  1292.  
  1293. Below are new commands as of version 14 that support Marc Reinig's terrain
  1294. features.
  1295.  
  1296. RANDOMIZE=nnn (0 - 100)\
  1297. This feature randomly varies the color of a pixel to near by colors.
  1298. Useful to minimize map banding in 3d transformations. Usable with all
  1299. FILLTYPES. 0 disables, max values is 7. Try 3 - 5.
  1300.  
  1301. AMBIENT=nnn (0 - 100)\
  1302. Set the depth of the shadows when using full color and light source
  1303. filltypes. "0" disables the function, higher values lower the contrast.
  1304.  
  1305. FULLCOLOR=yes\
  1306. Valid with any light source FILLTYPE. Allows you to create a Targa-24 file
  1307. which uses the color of the image being transformed or the map you select
  1308. and shades it as you would see it in real life. Well, its better than B&W.
  1309. A good map file to use is topo
  1310.  
  1311. HAZE=nnn (0 - 100)\
  1312. Gives more realistic terrains by setting the amount of haze for distant
  1313. objects when using full color in light source FILLTYPES. Works only in the
  1314. "y" direction currently, so don't use it with much y rotation. Try
  1315. "rotation=85/0/0". 0 disables.
  1316.  
  1317. LIGHTNAME=<filename>\
  1318. The name of the Targa-24 file to be created when using full color with
  1319. light source. Default is light001.tga. If overwrite=no (the default), the
  1320. file name will be incremented until an unused filename is found.
  1321. Background in this file will be sky blue.
  1322. ;
  1323. ;
  1324. ;
  1325. ~Topic=Batch Mode
  1326.  
  1327. It IS possible, believe it or not, to become so jaded with the screen
  1328. drawing process, so familiar with the types and options, that you just
  1329. want to hit a key and do something else until the final images are safe on
  1330. disk.  To do this, start Fractint with the BATCH=yes parameter.  To set up
  1331. a batch run with the parameters required for a particular image you might:
  1332.   o Find an interesting area.  Note the parameters from the <Tab> display.
  1333.     Then use an editor to write a batch file.
  1334.   o Find an interesting area.  Set all the options you'll want in the
  1335.     batch run.    Use the <B> command to store the parameters in a file.
  1336.     Then use an editor to add the additional required batch mode
  1337.     parameters (such as VIDEO=) to the generated parameter file entry.
  1338.     Then run the batch using "fractint @myname.par/myentry" (if you told
  1339.     the <B> command to use file "myname" and to name the entry "myentry").
  1340.  
  1341. Another approach to batch mode calculations, using "FILENAME=" and resume,
  1342. is described later.
  1343.  
  1344. When modifying a parameter file entry generated by the <B> command, the
  1345. only parameters you must add for a batch mode run are "BATCH=yes", and
  1346. "VIDEO=xxx" to select a video mode.  You might want to also add
  1347. "SAVENAME=[name]" to name the result as something other than the default
  1348. FRACT001.GIF.  Or, you might find it easier to leave the generated
  1349. parameter file unchanged and add these parameters by using a command like:
  1350.    fractint @myname.par/myentry batch=y video=AF3 savename=mygif
  1351.  
  1352. "BATCH=yes" tells Fractint to run in batch mode -- that is, Fractint draws
  1353. the image using whatever other parameters you specified, then acts as if
  1354. you had hit <S> to save the image, then exits to DOS.
  1355.  
  1356. "FILENAME=" can be used with "BATCH=yes" to resume calculation of an
  1357. incomplete image.  For instance, you might interactively find an image you
  1358. like; then select some slow options (a high resolution disk video mode,
  1359. distance estimator method, high maxiter, or whatever);    start the
  1360. calculation;  then interrupt immediately with a <S>ave.  Rename the save
  1361. file (fract001.gif if it is the first in the session and you didn't name
  1362. it with the <X> options or "savename=") to xxx.gif. Later you can run
  1363. Fractint in batch mode to finish the job:\
  1364.     fractint batch=yes filename=xxx savename=xxx
  1365.  
  1366. "SAVETIME=nnn" is useful with long batch calculations, to store a
  1367. checkpoint every nnn minutes.  If you start a many hour calculation with
  1368. say "savetime=60", and a power failure occurs during the calculation,
  1369. you'll have lost at most an hour of work on the image.  You can resume
  1370. calculation from the save file as above.  Automatic saves triggered by
  1371. SAVETIME do not increment the save file name. The same file is overwritten
  1372. by each auto save until the image completes.  But note that Fractint does
  1373. not directly over-write save files.  Instead, each save operation writes a
  1374. temporary file FRACTINT.TMP, then deletes the prior save file, then
  1375. renames FRACTINT.TMP to be the new save file.  This protects against power
  1376. failures which occur during a save operation - if such a power failure
  1377. occurs, the prior save file is intact and there's a harmless incomplete
  1378. FRACTINT.TMP on your disk.
  1379.  
  1380. If you want to spread a many-hour image over multiple bits of free machine
  1381. time you could use a command like:\
  1382.     fractint batch=yes filename=xxx savename=xxx savetime=60 video=F3\
  1383. While this batch is running, hit <S> (almost any key actually) to tell
  1384. fractint to save what it has done so far and give your machine back.  A status
  1385. code of 2 is returned by fractint to the batch file.  Kick off the batch
  1386. again when you have another time slice for it.
  1387.  
  1388. While running a batch file, pressing any key will cause Fractint to exit
  1389. with an errorlevel = 2.  Any error that interrupts an image save to disk
  1390. will cause an exit with errorlevel = 2.  Any error that prevents an image
  1391. from being generated will cause an exit with errorlevel = 1.
  1392.  
  1393. The SAVETIME= parameter, and batch resumes of partial calculations, only
  1394. work with fractal types which can be resumed.  See
  1395. {"Interrupting and Resuming"} for information about non-resumable types.
  1396. ;
  1397. ;
  1398. ;
  1399. ~Topic=Video Adapter Notes
  1400.  
  1401. True to the spirit of public-domain programming, Fractint makes only a
  1402. limited attempt to verify that your video adapter can run in the mode you
  1403. specify, or even that an adapter is present, before writing to it.
  1404. So if you use the "video=" command line parameter, check it before using
  1405. a new version of Fractint -
  1406. the old key combo may now call an ultraviolet holographic mode.
  1407. ~Doc-
  1408.  
  1409. Comments about some particular video adapters:\
  1410.     { EGA }      { Tweaked VGA }   { Super-VGA }\
  1411.     { 8514/A }      { XGA }\
  1412.     { Targa }      { Targa+ }\
  1413.  
  1414. Also see {Customized Video Modes\, FRACTINT.CFG}.
  1415. ~Doc+
  1416. ;
  1417. ;
  1418. ~Topic=EGA
  1419. ~Format-,Online-
  1420. EGA
  1421. ~Format+,Online+
  1422.  
  1423. Fractint assumes that every EGA adapter has a full 256K of memory
  1424. (and can therefore display 640 x 350 x 16 colors), but does nothing to
  1425. verify that fact before slinging pixels.
  1426. ;
  1427. ;
  1428. ~Topic=Tweaked VGA
  1429. ~Format-,Online-
  1430. "TWEAKED" VGA MODES
  1431. ~Format+,Online+
  1432.  
  1433. The IBM VGA adapter is a highly programmable device, and can be set up to
  1434. display many video-mode combinations beyond those "officially" supported
  1435. by the IBM BIOS. E.g. 320x400x256 and 360x480x256 (the latter is one of
  1436. our favorites).
  1437. These video modes are perfectly legal, but temporarily
  1438. reprogram the adapter (IBM or fully register-compatible) in a non-standard
  1439. manner that the BIOS does not recognize.
  1440.  
  1441. Fractint also contains code that sets up the IBM (or any truly register-
  1442. compatible) VGA adapter for several extended modes such as 704x528,
  1443. 736x552, 768x576, and 800x600. It does this by programming the VGA
  1444. controller to use the fastest dot-clock on the IBM adapter (28.322 MHz),
  1445. throwing more pixels, and reducing the refresh rate to make up for it.
  1446.  
  1447. These modes push many monitors beyond their rated specs, in terms of both
  1448. resolution and refresh rate. Signs that your monitor is having problems
  1449. with a particular "tweaked" mode include:
  1450.  o vertical or horizontal overscan (displaying dots beyond the edges of
  1451.    your visible CRT area)
  1452.  o flickering (caused by a too-slow refresh rate)\
  1453.  o vertical roll or total garbage on the screen (your monitor simply
  1454.    can't keep up, or is attempting to "force" the image into a pre-set
  1455.    mode that doesn't fit).
  1456.  
  1457. We have successfully tested the modes up to 768x576 on an IBM PS/2 Model
  1458. 80 connected to IBM 8513, IBM 8514, NEC Multisync II, and Zenith 1490
  1459. monitors (all of which exhibit some overscan and flicker at the highest
  1460. rates), and have tested 800x600 mode on the NEC Multisync II (although it
  1461. took some twiddling of the vertical-size control).
  1462. ;
  1463. ;
  1464. ~Topic=Super-VGA
  1465. ~Format-,Online-
  1466. SUPER-EGA AND SUPER-VGA MODES
  1467. ~Format+,Online+
  1468.  
  1469. Since version 12.0, we've used both John Bridges' SuperVGA Autodetecting
  1470. logic *and* VESA adapter detection, so that many brand-specific SuperVGA
  1471. modes have been combined into single video mode selection entries.
  1472. There is now exactly one entry for SuperVGA 640x480x256 mode, for instance.
  1473.  
  1474. If Fractint's automatic SuperVGA/VESA detection logic guesses wrong,
  1475. and you know which SuperVGA chipset your video adapter uses, you can use
  1476. the "adapter=" command-line option to force Fractint to assume the presence
  1477. of a specific SuperVGA Chipset - see {Video Parameters} for details.
  1478. ;
  1479. ;
  1480. ~Topic=8514/A
  1481. ~Format-,Online-
  1482. 8514/A MODES
  1483. ~Format+,Online+
  1484.  
  1485. The IBM 8514/A modes (640x480 and 1024x768) default to using the hardware
  1486. registers.  If an error occurs when trying to open the adapter, an attempt
  1487. will be made to use IBM's software interface, and requires the preloading
  1488. of IBM's HDILOAD TSR utility.
  1489.  
  1490. The Adex 1280x1024 modes were written for and tested on an Adex
  1491. Corporation 8514/A using a Brooktree DAC.  The ATI GU 800x600x256 and
  1492. 1280x1024x16 modes require a ROM bios version of 1.3 or higher for 800x600
  1493. and 1.4 or higher for 1280x1024.
  1494.  
  1495. There are two sets of 8514/A modes: full sets (640x480, 800x600, 1024x768,
  1496. 1280x1024) which cover the entire screen and do NOT have a border color
  1497. (so that you cannot tell when you are "paused" in a color-cycling mode),
  1498. and partial sets (632x474, 792x594, 1016x762, 1272x1018) with small border
  1499. areas which do turn white when you are paused in color-cycling mode. Also,
  1500. while these modes are declared to be 256-color, if you do not have your
  1501. 8514/A adapter loaded with its full complement of memory you will actually
  1502. be in 16-color mode. The hardware register 16-color modes have not been
  1503. tested.
  1504.  
  1505. If your 8514/A adapter is not truly register compatible and Fractint does
  1506. not detect this, use of the adapter interface can be forced by using afi=y
  1507. or afi=8514 in your SSTOOLS.INI file.
  1508.  
  1509. Finally, because IBM's adapter interface does not handle drawing single
  1510. pixels very well (we have to draw a 1x1 pixel "box"), generating the zoom
  1511. box when using the interface is excruciatingly slow. Still, it works!
  1512. ;
  1513. ;
  1514. ~Topic=XGA
  1515. ~Format-,Online-
  1516. XGA MODES
  1517. ~Format+,Online+
  1518.  
  1519. The XGA adapter is supported using the VESA/SuperVGA Autodetect modes -
  1520. the XGA looks like just another SuperVGA adapter to Fractint.
  1521. The supported XGA modes are 640x480x256, 1024x768x16, 1024x768x256,
  1522. 800x600x16, and 800x600x256.  Note that the 1024x768x256 mode requires
  1523. a full 1MB of adapter memory, the 1024x768 modes require a high-rez
  1524. monitor, and the 800x600 modes require a multisynching monitor such
  1525. as the NEC 2A.
  1526. ;
  1527. ;
  1528. ~Topic=Targa
  1529. ~Format-,Online-
  1530. TARGA MODES
  1531. ~Format+,Online+
  1532.  
  1533. TARGA support for Fractint is provided courtesy of Joe McLain and has been
  1534. enhanced with the help of Bruce Goren and Richard Biddle.  To use a TARGA
  1535. board with Fractint, you must define two DOS environment variables,
  1536. "TARGA" and "TARGASET".  The definition of these variables is standardized
  1537. by Truevision; if you have a TARGA board you probably already have added
  1538. "SET" statements for these variables to your AUTOEXEC.BAT file.
  1539. Be aware that there are a LOT of possible TARGA configurations, and a LOT
  1540. of opportunities for a TARGA board and a VGA or EGA board to interfere
  1541. with each other, and we may not have all of them smoothed away yet.  Also,
  1542. the TARGA boards have an entirely different color-map scheme than the VGA
  1543. cards, and at the moment they cannot be run through the color-cycling
  1544. menu. The "MAP=" argument (see {Color Parameters}),
  1545. however, works with both TARGA and
  1546. VGA boards and enables you to redefine the default color maps with either
  1547. board.
  1548. ;
  1549. ;
  1550. ~Topic=Targa+
  1551. ~Format-,Online-
  1552. TARGA+ MODES
  1553. ~Format+,Online+
  1554.  
  1555. To use the special modes supported for TARGA+ adapters, the TARGAP.SYS
  1556. device driver has to be loaded, and the TPLUS.DAT file (included with
  1557. Fractint) must be in the same directory as Fractint.  The video modes with
  1558. names containing "True Color Autodetect" can be used with the Targa+.  You
  1559. might want to use the command line parameters "tplus=", "noninterlaced=",
  1560. "maxcolorres=", and "pixelzoom=" (see {Video Parameters})
  1561. in your SSTOOLS.INI file to modify Fractint's use of the adapter.
  1562. ;
  1563. ;
  1564. ~Topic="Disk-Video" Modes
  1565.  
  1566. These "video modes" do not involve a video adapter at all. They use (in
  1567. order or preference) your expanded memory, your extended memory, or your
  1568. disk drive (as file FRACTINT.$$$) to store the fractal image. These modes
  1569. are useful for creating images beyond the capacity of your video adapter
  1570. right up to the current internal limit of 2048 x 2048 x 256,
  1571. e.g. for subsequent printing.
  1572. They're also useful for
  1573. background processing under multi-tasking DOS managers - create an image
  1574. in a disk-video mode, save it, then restore it in a real video mode.
  1575.  
  1576. While you are using a disk-video mode, your screen will display text
  1577. information indicating whether memory or your disk drive is being used,
  1578. and what portion of the "screen" is being read from or written to.  A
  1579. "Cache size" figure is also displayed. 64K is the maximum cache size.  If
  1580. you see a number less than this, it means that you don't have a lot of
  1581. memory free, and that performance will be less than optimum.  With a very
  1582. low cache size such as 4 or 6k, performance gets considerably worse in
  1583. cases using solid guessing, boundary tracing, plasma, or anything else
  1584. which paints the screen non-linearly.  If you have this problem, all we
  1585. can suggest is having fewer TSR utilities loaded before starting Fractint,
  1586. or changing in your config.sys file, such as reducing a very high BUFFERS
  1587. value.
  1588.  
  1589. The zoom box is disabled during disk-video modes (you couldn't see where
  1590. it is anyway).    So is the orbit display feature.
  1591.  
  1592. {=@ColorCycling Color Cycling} can be used during disk-video modes,
  1593. but only to load or save a color palette.
  1594.  
  1595. When using real disk for your disk-video, Fractint will not generate some
  1596. "attractor" types (e.g. lorenz) nor "IFS" images.  These would kill your
  1597. disk drive.  Boundary tracing is allowed - it may give your drive a bit of
  1598. a workout, but is generally tolerable.
  1599.  
  1600. When using a real disk, and you are not directing the file to a RAM disk,
  1601. and you aren't using a disk caching program on your machine, specifying
  1602. BUFFERS=10 (or more) in your config.sys file is best for performance.
  1603. BUFFERS=10,2 or even BUFFERS=10,4 is also good.  It is also best to keep
  1604. your disk relatively "compressed" (or "defragmented") if you have a
  1605. utility to do this.
  1606.  
  1607. In order to use extended memory, you must have HIMEM.SYS or an equivalent
  1608. that supports the XMS 2.0 standard or higher.  Also, you can't have a
  1609. VDISK installed in extended memory.  Himem.sys is distributed with
  1610. Microsoft Windows 286/386 and 3.0.  If you have problems using the
  1611. extended memory, try rebooting with just himem.sys loaded and see if that
  1612. clears up the problem.
  1613.  
  1614. If you are running background disk-video fractals under Windows 3, and you
  1615. don't have a lot of real memory (over 2Mb), you might find it best to
  1616. force Fractint to use real disk for disk-video modes.  (Force this by
  1617. using a .pif file with extended memory and expanded memory set to zero.)
  1618. Try this if your disk goes crazy when generating background images, which
  1619. are supposedly using extended or expanded memory.  This problem can occur
  1620. because, to multi-task, sometimes Windows must page an application's
  1621. expanded or extended memory to disk, in big chunks. Fractint's own cached
  1622. disk access may be faster in such cases.
  1623. ;
  1624. ;
  1625. ;
  1626. ~Topic=Customized Video Modes\, FRACTINT.CFG
  1627.  
  1628. If you have a favorite adapter/video mode that you would like to add to
  1629. Fractint... if you want some new sizes of disk-video modes... if you want
  1630. to remove table entries that do not apply to your system... if you want to
  1631. specify different "textsafe=" options for different video modes... relief
  1632. is here, and without even learning "C"!
  1633.  
  1634. You can do these things by modifying the FRACTINT.CFG file with your text
  1635. editor. Saving a backup copy of FRACTINT.CFG first is of course highly
  1636. recommended!
  1637.  
  1638. Fractint uses a video adapter table for most of what it needs to know
  1639. about any particular adapter/mode combination. The table is loaded from
  1640. FRACTINT.CFG each time Fractint is run. It can contain information for
  1641. up to 300 adapter/mode combinations. The table entries, and the function
  1642. keys they are tied to, are displayed in the "select video mode" screen.
  1643.  
  1644. This table makes adding support for various third-party video cards and
  1645. their modes much easier, at least for the ones that pretend to be
  1646. standard with extra dots and/or colors. There is even a special
  1647. "roll-your-own" video mode (mode 19) enabling those of you with "C"
  1648. compilers and a copy of the Fractint source to generate video modes
  1649. supporting whatever adapter you may have.
  1650.  
  1651. The table as currently distributed begins with nine standard and several
  1652. non-standard IBM video modes that have been exercised successfully with a
  1653. PS/2 model 80. These entries, coupled with the descriptive comments in the
  1654. table definition and the information supplied (or that should have been
  1655. supplied!) with your video adapter, should be all you need to add your own
  1656. entries.
  1657.  
  1658. After the IBM and quasi-pseudo-demi-IBM modes, the table contains an ever-
  1659. increasing number of entries for other adapters. Almost all of these
  1660. entries have been added because someone like you sent us spec sheets, or
  1661. modified Fractint to support them and then informed us about it.
  1662.  
  1663. Lines in FRACTINT.CFG which begin with a semi-colon are treated as comments.
  1664. The rest of the lines must have eleven fields separated by commas.
  1665. The fields are defined as:
  1666.  
  1667. ~Format-
  1668. 1. Key assignment. F2 to F10, SF1 to SF10, CF1 to CF10, or AF1 to AF10.
  1669.    Blank if no key is assigned to the mode.
  1670. 2. The name of the adapter/video mode (25 chars max, no leading blanks).
  1671.    The adapter is set up for that mode via INT 10H, with:
  1672. 3. AX = this,
  1673. 4. BX = this,
  1674. 5. CX = this, and
  1675. 6. DX = this (hey, having all these registers wasn't OUR idea!)
  1676. 7. An encoded value describing how to write to your video memory in that
  1677.    mode. Currently available codes are:
  1678.   1) Use the BIOS (INT 10H, AH=12/13, AL=color) (last resort - SLOW!)
  1679.   2) Pretend it's a (perhaps super-res) EGA/VGA
  1680.   3) Pretend it's an MCGA
  1681.   4) SuperVGA 256-Color mode using the Tseng Labs chipset
  1682.   5) SuperVGA 256-Color mode using the Paradise chipset
  1683.   6) SuperVGA 256-Color mode using the Video-7 chipset
  1684.   7) Non-Standard IBM VGA 360 x 480 x 256-Color mode
  1685.   8) SuperVGA 1024x768x16 mode for the Everex chipset
  1686.   9) TARGA video modes
  1687.  10) HERCULES video mode
  1688.  11) Non-Video, i.e. "disk-video"
  1689.  12) 8514/A video modes
  1690.  13) CGA 320x200x4-color and 640x200x2-color modes
  1691.  14) Reserved for Tandy 1000 video modes
  1692.  15) SuperVGA 256-Color mode using the Trident chipset
  1693.  16) SuperVGA 256-Color mode using the Chips & Tech chipset
  1694.  17) SuperVGA 256-Color mode using the ATI VGA Wonder chipset
  1695.  18) SuperVGA 256-Color mode using the EVEREX chipset
  1696.  19) Roll-your-own video mode (as you've defined it in YOURVID.C)
  1697.  20) SuperVGA 1024x768x16 mode for the ATI VGA Wonder chipset
  1698.  21) SuperVGA 1024x768x16 mode for the Tseng Labs chipset
  1699.  22) SuperVGA 1024x768x16 mode for the Trident chipset
  1700.  23) SuperVGA 1024x768x16 mode for the Video 7 chipset
  1701.  24) SuperVGA 1024x768x16 mode for the Paradise chipset
  1702.  25) SuperVGA 1024x768x16 mode for the Chips & Tech chipset
  1703.  26) SuperVGA 1024x768x16 mode for the Everex Chipset
  1704.  27) SuperVGA Auto-Detect mode (we poke around looking for your adapter)
  1705.  28) VESA modes
  1706.  29) True Color Auto-Detect (currently only Targa+ supported)
  1707. Add 100, 200, 300, or 400 to this code to specify an over-ride "textsafe="
  1708.  option to be used with the mode.  100=yes, 200=no, 300=bios, 400=save.
  1709.  E.g. 428 for a VESA mode with textsafe=save forced.
  1710. 8. The number of pixels across the screen (X - 160 to 2048)
  1711. 9. The number of pixels down the screen (Y - 160 to 2048)
  1712. 10. The number of available colors (2, 4, 16, or 256)
  1713. 11. A comment describing the mode (25 chars max, leading blanks are OK)
  1714. ~Format+
  1715.  
  1716. NOTE that the AX, BX, CX, and DX fields use hexadecimal notation (fifteen
  1717. ==> 'f', sixteen ==> '10'), because that's the way most adapter
  1718. documentation describes it. The other fields use standard decimal
  1719. notation.
  1720.  
  1721. If you look closely at the default entries, you will notice that the IBM
  1722. VGA entries labeled "tweaked" and "non standard" have entries in the table
  1723. with AX = BX = CX = 0, and DX = some other number. Those are special flags
  1724. that we used to tell the program to custom-program the VGA adapter, and
  1725. are NOT undocumented BIOS calls. Maybe they should be, but they aren't.
  1726.  
  1727. If you have a fancy adapter and a new video mode that works on it, and it
  1728. is not currently supported, PLEASE GET THAT INFORMATION TO US!    We will
  1729. add the video mode to the list on our next release, and give you credit
  1730. for it. Which brings up another point: If you can confirm that a
  1731. particular video adapter/mode works (or that it doesn't), and the program
  1732. says it is UNTESTED, please get that information to us also.  Thanks in
  1733. advance!
  1734. ;
  1735. ;
  1736. ;
  1737.